MediaSetClip(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 10 - Derived Media Handler Components / Derived Media Handler Components Reference

Functions / Graphics Data Management

MediaSetClip
The MediaSetClip function allows your derived media handler to learn about changes to its clipping region.
pascal ComponentResult MediaSetClip (ComponentInstance ci,
                                     RgnHandle theClip);
ci
Identifies the Movie Toolbox's connection to your derived media handler.
theClip
Contains a handle to your media's clipping region. Your media handler is responsible for disposing of this region when you are done with it. Note that this region lies in the movie's coordinate system.

DESCRIPTION
The Movie Toolbox calls your derived media handler's MediaSetClip function whenever the track's clipping region changes. The toolbox provides you with a handle to a clipping region that supersedes any other clipping region you may be using.
Your derived media handler should support this function if you draw during playback.
The Movie Toolbox calls this function only if you have set the handlerHasSpatial and handlerCanClip flags to 1 in the flags parameter of the MediaSetHandlerCapabilities function (described on page 10-36).

RESULT CODES
Any Component Manager result code